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Overview 


abstract 


abstract 


xf86-input-joystick? 
e not meant for playing games under X 
e input module for the X.Org server to handle classical joysticks 
e can emit pointer movement and key events 
e control the cursor with a joystick 


A 
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xf86-input-joystick 


why joysticks? 


e cheap remote control 
e being lazy 
e watching movies from couch 
e control music 


e interactive kiosk systems 
e replace fragile mouse/touchpad 
e console and media center systems 


e Linux on XBox, PS2, ... 
e Steam Big Picture going there 
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classical joysticks 


a lot of different hardware configurations 
easily 6 or more axes, different types 

e directional pad 

e hat switch 

e analog sticks 
bunch of buttons, easily 10 and more 
force feedback 
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physical joysticks 
ke 


why a joystick input module? 


e xorg-server knows pointers and keyboards 
e xf86-input-evdev maps directly 
e evdev only in Linux 


e joysticks usually send absolute axis data 
=> direct mapping useless 
=> joystick specific event transformation needed 


absolute axes (ai) = | fl ye => See 
buttons e t = s 
Nm <_<” 


x keys 


e 
joystick data transformation v Y 
X events 
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Basics 


joysticks on kernel level 


kernel device 

e usually Plug & Play (USB) 

e event driven = no polling 
Linux 

e /dev/input/js0 (joydev) 

e /dev/input/eventO (evdev) 
(Free)BSD 

e /dev/input/js0 (linux-js) 

e /dev/uhidO (usbhid) 


— lightweight abstraction layer x 
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Details 


axis Mappings 


mapping mode 
e relative (analog) 
e accelerated (D-Pad) 
e absolute (analog) 
mapping type 
e pointer movement 


e scroll event 


key event sequence (e.g. cursor keys) 


e none + raw valuator events (XI2) 
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Details 


button mappings 


pointer click 


pointer movement (accelerated) 


scroll events (accelerated) 
key sequences (e.g. Alt+Tab) 


e auto repeat applies 
e keyboard layout applies 


disable all events temporarily 
e still allows playing games 
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Details 


hotplugging and configuration 


e can be hotplugged through udev and xorg.conf.d 


e allows specific configuration 
e easy pre-configuration through distributors 


e no EVIOCGRAB 

e allows concurrent reads (e.g. for games) 

e watch out when hotplugging jsO and event 
e supports input device properties 


e most configuration items can be changed at runtime 
e TODO: frontend 
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Details 


distribution default 


e mostly installed unintentionally 
=> yields unexpected behaviour 
default should be disabled /floating 
make user aware to enable it during installation 
popup from DE on hotplug event 
way to activate/deactivate it on the fly 


e no reasonable default configuration 
e example configuration 
e configuration wizard (xorg.conf.d) 
e frontend for runtime configuration (properties, dynamic 
hotplugging) 
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d 
Details keyboard 


pointer vs. keyboard 


e X.Org server strictly separates pointers and keyboards 
e no hybrid input devices 
= xf86-input-joystick has to create two input devices 


e properties only on pointer 
e keyboard layout and autorepeat on keyboard 
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d 
Details keyboard 


keyboard configuration 


e user wants KeySyms (space, Return, XF86AudioPlay, ...) 
e driver emits scancodes 
e keyboard layout = unwanted indirection layer 
e current layout unknown to driver 
e no custom keyboard layout from within driver 
e different auto repeat rate possible 
=> difficult to configure 
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Details 


raw valuators 


raw valuator events 


e valuators 0 and 1 reserved for pointer movement 
e optional raw valuators per axis 


e useful for XI2 applications (e.g. gimp) 
e less useful for games 
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platforms 


Future 


platforms 


e focus on Linux 

end user desktop systems 
interactive kiosk systems 

console systems (XBox, PS2/3, ...) 
Wii remote? Kinect? 

= not classical joysticks 

=> different module 


e support for Solaris, etc. possible 
=> not attractive enough 
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platforms 


features 


Future 


force feedback 


e events from toolkit 


e event infrastructure from client to server 
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Future 


possible features 


e most properties implemented 
e still some work left 
e input only “frontend” for properties 


e driver can deactivate/activate itself 
e GTK/Qt frontend with support for “profiles” would be nice 
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Thank you! 
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